Сообщения

Сообщения — это просто строка в вашем скрипте которая будет отправленна пользователю. Каждая строка в вашем скрипте будет отображена как отдельное сообщение, если это не команда или комментарий.

Написание сообщений

Сообщения — это обычные строки текста, которые отправляются в игру по одной и отображаются пользователю.

Например, простое сообщение может выглядеть так:

Это сообщение в t-Plot.

Сообщения могут содержать любой текст, но некоторые специальные символы нужно экранировать.

Форматирование текста

Так как t-Plot использует парсер Yarn Spinner и стремится к полной совместимости с ним, есть некоторые особенности в формате сообщений:

• Speaker: Вы можете указать имя персонажа, который говорит строку, используя двоеточие : после имени персонажа.

  в скрипте:

  Анна: Привет!

  в игре:

  Анна:
  Привет!

• Переносы строк: Каждая строка — это отдельное сообщение. Чтобы сделать перенос строки внутри сообщения, используйте тэг [br/].

  в скрипте:

  Это первая строка.[br/]Это вторая строка.

  в игре:

  Это первая строка.
  Это вторая строка.

• Экранирование символов: Некоторые символы нужно экранировать, чтобы они не воспринимались как команды или специальные символы. Это: \[, \], \<, \>, \/, \{, \}, и \#. Если вам нужно использовать эти символы в тексте, добавьте перед ними обратный слеш \.

  в скрипте:

  Это сообщение содержит символы: \[ \] \< \> \{ \} \# \/

  в игре:

  Это сообщение содержит символы: [ ] < > { } # /

Двоеточие :

В Yarn Spinner двоеточие используется для указания имени персонажа, который говорит строку. Если вам нужно использовать двоеточие в тексте, используйте [cl/]

в скрипте:

Это сообщение[cl/] это пример использования двоеточия.

в игре:

Это сообщение: это пример использования двоеточия.

Знак доллара $

Чтобы включить знак доллара в ваше сообщение, используйте [usd/].

в скрипте:

[usd/]100

в игре:

$100

Поддерживаемые теги форматирования

Вы можете форматировать ваши сообщения с помощью следующих тегов:

• [i]Курсив[/i]
• [b]Жирный текст[/b]
• [u]Подчёркнутый текст[/u]
• [s]Зачёркнутый текст[/s]
• [link https://docs.tplot.com]Ссылка[/link]
• [spoiler]Спойлер[/spoiler]
• [ms]Код[/ms]

link

Символы url в теге link не нужно экранировать или заменять : на [cl/], просто вставьте ссылку в тег как есть.

Типы сообщений

Вы можете использовать различные типы медиа сообщений, просто начните строку с соответствующего тега:

Фото

// фото с описанием
[photo test.jpeg /]Описание

// фото с описанием и спикером
player: [photo test.jpeg /]Описание

// фото без описания
[photo test.jpeg /]

Где test.jpeg — это имя файла в папке media. Поддерживаются только форматы jpg и jpeg. Описание можно форматировать так же, как и обычное сообщение или не указывать его.

Голосовое сообщение

// голосовое сообщение с описанием
[voice test.mp3 /]Описание

// голосовое сообщение без описания
[voice test.mp3 /]

Где test.mp3 — это имя файла в папке media. Поддерживается только формат mp3. Описание можно форматировать так же, как и обычное сообщение или не указывать его.

Видео-заметки

[video_note test.mp4 /]

Где test.mp4 — это имя файла в папке media. Этот формат не поддерживает описание.

Рекомендуемые параметры видео

Для видео-заметок рекомендуется использовать видео с разрешением 640x640 пикселей и длительностью не более 59 секунд.

Видео

// видео с описанием
[video test.mp4 /]Описание

// видео без описания
[video test.mp4 /]

Где test.mp4 — это имя файла в папке media. Описание можно не указывать.